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MODULE S$xwbdef 


Version: *v04-000' 


XWBDEF .SDL - Logical-Link nonpaged control structures 


PARRA SASAASAALALASAAALALALALATELASE ALES AREAS SELES EERE RES RS EERE RES ER EERE CEES 


COPYRIGHT (c) 1978, 1980, 1982, 1984 B 
DIGITAL EQUIPMENT CORPORATION, MAYNARD. MASSACHUSETTS. 
ALL RIGHTS RESERVED. 


al Sack I$ wee aitee UNDER A LICENSE AND MAY BE USED AND sorter 
oat: IN ACCORDANCE W THE TE TH THE 


* 
*® 
® 
® 
® 
& 
INC OTHER * 
COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY © 
OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY * 
TRANSFERRED. ° 
w 
THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE ®* 
® 
* 
® 
® 
® 
® 
ae 
® 


AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 
CORPORATION. 


DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS 
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 


Bete Se Ge Ge Se Ge Se Se Se Se Se Se Se Se Se Se Se Se Se Se Se Se 


PARRBRRASASLASAALASLALELALASALE SALA LELASESARASAR ALES SRSA A ASRS ERLE ASSES ALAS SE SC 


AUTHOR: Alan D. Eldridge 1-April-1982 
MODIFIED BY: 
V03-006 RNGOO006 Rod Gamache 11-Jun-1984 


Add XWBSV_STS_NDC node counter access bit to XWB. 


v03-005 aocore! dge 21-0ct-1982 
Significant LSB stb Be ion. Removed DLE stuff from XwB. 


AAAAAAAA AAA AAA AAAAAAAAAAAAAA AAA 
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LOGICAL“LINK SUBCHANNEL BLOCK (LSB) 
The block is used to control the nn hb on a logical Link 
subchannel. There are two subchannels: the DATA subchannel and the 
INTERRUPT/LINK SERVICE subchannel. 
é 
AGGREGATE sb STRUCTURE PREFIX lsb$ ; { Link Subchannel Block 


{ KEEP LONGWORDS, WORDS, AND BYTES ALIGNED ON THEIR APPROPRIATE BOUNDARIES 


{ 
t Transmitter control variables 


lux WORD; Last segment # asgignes to a segment 
inx WORD; Last segment # xmitted 

hxs WORD; Highest segment # sendable 

har WORD; Highest ACK # reccived 

haa WORD; Highest ACK # acceptable 


Flow control credits from remote receiver 


x_re BYTE; 


x_ad BYTE; Packet window adjustment counter 

x_pktwnd BYTE; { Size of the transmit-packet-window 

x_cxbact BYTE; { Number of active transmit CXB's 

x_cxbquo BYTE; { Max total CXB's allowed 

x_cxbcent BYTE; { Total CXB's both active on on the free queue 

x_pnd ADDRESS TAG L; { Listhead for xmt IRP's containing data 

x_ir ADDRESS TAG L; ({ Listhead for xmt IRP's with data moved to CXBs 

KCK ADDRESS TAG L; { Transmit CXB (message segments) Listhead 

{ 

t Receiver control variables 

r_ir ADDRESS TAG L; Receive IRP Listhead 

ricx ADDRESS TAG L; Received CXB (message segments) Listhead 

hnr WORD; Highest numbered msg received and accepted 

hax WORD; Highest ACK xmitted 

r_cxbent BYTE; Number of CXB's in LSB List (unACK'ed) 

r_cxbquo BYTE; Max rcv CXB's which can be buffered by NSP | 
before some are passed to the Session Layer 

spare BYTE; { Spare, used for alignment 


{ 
; Miscellaneous 


sts STRUCTURE TAG b; = { Status bits 


li BITFIELD MASK; Set for LS/INT subchannel 

spare BITFIELD LENGTH 4; skip over to coincide with NSP bits 
bom Bitet LD MASK; Next seg to send has NSP$V_DATA_BOM 
eom BITFIELD MASK; Next seg to send has NSPSV_DATA_EOM 
ND 


END sts; 
cross ADDRESS TAG L; { Pointer to ‘‘cross-channel'’ LSB 


#isb_lng = .; Length for use by XWB definition 
END tsb? f ° . 


set 
set 
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NETWORK WINDOW BLOCK (XWB) = Network version of a WCB 


This control block serves as the Network Window Control oentre as such 
its header section must look Like a WCB. The remainder ot f 
structure is Network specific. There is one XwB per logical Mf ink. 


AGGREGATE xwb STRUCTURE PREFIX xwb$ ; 


The header portion of the block tracks the WCB format 


Lfl ADDRESS TAG L; Window List forward Link 
wlbl ADDRESS TAG L; Window List backward Link 
size WORD; Bytes allocated for structure 


type BYTE: Contains code identifying structure 


access BYTE; IO$_ACCESS control +a: Coge wCB Sef inition) 
refcnt . Count of accessors of the window 
sts STRUCTURE TAG w: Cegteros the miscellaneous stetus flags. 


(DECnet s ARSE ) 
sts_tid BITFIELD MASK; Set if xi su TIM. ID is currently in use 


sts_tli BITFIELD MASK; et iy XWBSW"TIM_ID used by ty LI subchannel 

sts_sol BITFIELD MASK; Set if the xOB fork block is in use 

sts_dis BITFIELD MASK; Set ! nod Bs disconnect is pending 
awaiti ng RUN state run-down 

sts_con BITFIELD MASK; Set om L o> enters the RUN state 

sts_tmo BITFIELD MASK; Link timed o 

sts_rop BITFIELD MASK; Set if oe A pad is back-pressured off 

sts_ovf BITFIELD MASK; Set if local rcvr is in ‘‘overflow'’ state 

sts_dtnak BITFIELD MASK; Set if next DATA ACK should be a NAK 

sts_linak BITFIELD MASK; Set if next LS/INT aod ghouls be a NAK 

sts_astpnd BITFIELD MASK; Special Kernel AST pend ing 

sts_astreq BITFIELD MASK; ; Special Kernel AST requested 

sts_ndc BITFIELD MASK; ; Set if NODE COUNTER BLOCK is accessed 

END sts; ; 

orgucb ADDRESS TAG L; { Original UCB address 


{ 
; The remainder of the block is DECnet specific. 


Fork queue Linkage 


fork QUADWORD; ge 
tlg STRUCTURE TAG w: Flags to control message xmission. 


f Because an FFS instruction is used on the tol loving to etermine 
; what to do next, the order of the bit definitions is critical. 
f 


lg_break BITFIELD MASK; { Break the Link 


Peeeeteeess FP BF 2ZZBZF Aaa tt 
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sta 


) 
EQUALS 0 
TAG ¢; 


Monp: 


BYTE; 
CONSTANT (sta wrt 


LD MASK; 
LD MASK; 
LD : 
LD MASK; 


f 
f 
f 
f 
f 
f 
f 
f 
f 
The next 4 flags are used for controlling when and how the next 
{ 
{ 
{ 
{ 
f 
f 
f 
f 


fipi BYTE; 

tp ADDRESS TAG L; 
fr LONGWORD; 

fré LONGWORD: 

Link ADDRESS TAG L; 
veb ADDRESS TAG L: 
pid LONGWORD; 

path WORD; 


i 
i 
INCREMENT | 
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Wait for buffer availability 
Send WH bs ACK 

Send DATA ACK 

Send INT/LS message 


its are wait conditions on the DATA subchannel 


Wait for HXS to become less than LUX 
Wait for backpressure to be relaxed 


Send a DATA message 
ae Connect” or Disconnect 

lose the Link and deal locate the XwB 
dalting for transmit CXB useage to go 
below quota 


Link Service subchannel message is to be built. They do not by 
themselves indicate that the message is to be transmitted. 


Since the are scanned via a FFS instruction, they must be defined 
in order of their priority. 


gpie back=-pressure at remote end 
ie interrupt message 
Build INT flow ctl msg 
Build DATA flow ctl msg 


Logical te states 
Closed 

Connect ‘initiate Sending 
Connect Ack Received 
Connect Initiate Received 
Connect Confirm Sending 


AE Initiate Received 
Disconnect Initiate qoneses 

Number of states (this works since 

these constants start at ‘0"'). This 
value (8) allows a qeotuere er 

event in the erate tables. Changing 

it mex OF be difficult. 

Fork IPL level 
Fork process PC value 
Fork process R5 value 

Fork process R4 value 
Link for XWB list 
Ptr to Volume Centres Block sectuat ty RCB) 
1.0. of process given connect 
Path sett eu t number) over which to xmit. 
Zero impl os engene the ss rcuit number 
dynamically. High byte is a sequence # 
Network address of partner node 
Remote node's link address 


Ma 
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Loc Lnk WORD; Local Link address 
locsiz WORD; Maximum receiv v9 segment size 
remsiz WORD; Maximum transmit segment size 
r_reason WORD; Received disconnect reason 
x “reason WORD; Piscennect B pene code to send to remote 
tim_id WORD; Identity ef evthe't being timed 
elapse WORD; zee nds since the timer was last reset 
tia, inact WORD; Maximum inactivity interval, in seconds 
delay WORD; Estimated seconds between xmission and ACK 
tiner WORD; Current timer value, in seconds 
progress WORD; Logical Link confidence variable 
retran WORD; Max imum Fotrenaates tens before Link is to 
be Staconnes tod 
dly_fact WORD; Retransmission timer delay vor ter 
dly_wght WORD; Retransmission timer delay weight 
pro STRUCTURE TAG b; Partner's protocol capabilities 
pro_nfc BITFIELD MASK; { Partner's receiver uses ‘‘no-flow 
pro_ =sts BITFIELD MASK; Partner's receiver “ee “segment flow'’ 
pro_ph BITFIELD MASK; Parnter is Phase ii es timer support) 
pro_cca BITFIELD MASK; Cross-channel ACKing allowed 
pro_nar BITFIELD MASK; Can send ‘'no ack request’ flag to partner 
END pro; 
#x = 16; S 
CONSTANT data Max size of DATA text field 
EQUALS @x TAG ¢c: 
data YTE; { Count of bytes used in next field 
data CHARACTER Z Optional data to be sent in next connect 
LENGTH @x; ; or disconnect message 
x_flw BYTE; Transmit Link service/flow control info 
x_flwent BYTE: Flow control count for next Link service 
goseege to be transmitted 
sp3 BYTE; Spare for ele igraent 
Ox = 16; Size RID l 
CONSTANT rid f Max size ft RID text field 
EQUALS @x TAG c; 
rid { Remote user (process, task, etc.) i.d. 
rid CHARACTER ; 
LENGTH ax; 
jre.ac acc LONGWORD ; Ptr to IO$_ACCESS IRP (0 if none) 
CONSTANT ‘te We Define room for counter block 
Saun : ents TAG ¢c; } 
ndc YTE TAG Counter block area 
¢ DIMENSION inde ; 


¢ The remainder of the structure is multiplexed Sopend ing upon the NSP 
logical-Link state, and depending upon whether the XWB is used for 
logical-lLinks or for Direct-line access. 


coming UNION TAG ¢; mvese. Cons is the length of the common 
area a 
run_blk STRUCTURE; While in the RUN state 


a 


| 
ize DATA field 
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_ CHARACTER LENGTH ((.4+3)8(-4))-.:¢ Force longword Ot ignnent 
dt few gly LENGTH @ls b. Ln 09: DATA subchanne 
CHARACTER LENGTH ((.43)8(-6))-.:¢ Force Longword a t pagent 
li CHARACTER LENGTH #Lsb_ing; LS/INT subchannel 
Dd; IO$S_DEACCESS IRP 


dea_irp fon bth : 
END k; 


con_blk STRUCTURE; For ath “connect’’ states the field usage 
is as follows. Process names contain a 
torent field in the first byte, and have 


the following lorantas 


9 followed by 1 byte non-zero object # 
followed by 1 byte of zero (object #) 
followed by a counted (max 16 bytes of 
test) object name 
ee by 1 byte of zero (object #) 
followed by 2 byte group code, § byte 
user code, and a counted (max 12 bytes 
of text object name 


rprnam CHARACTER LENGTH @y; a By process name 


2s Max size of process name field 
C Stat eWuReS ays vr rnan) size. e ot the following count and text 
Cs 
lprnam BY i ‘field for local process name 
Lornam CHARACTER LENGTH @y; wee process name 
rprnam xoun ield for remote process name 
Max 


ohus size of LOGIN compound string 
C srhnt Login EQUALS: y+ 


login BYTE; 
login CHARACTER LENGTH #y; 


icb ADDRESS TAG |; 
ci_path WORD; 


ze of LOGIN compound strings + count 


§ tex 

{ fie 
Co a of the following composite field 

(mininum value is 3) 

Taree eenenge seseed counties account strings 
(min value gree ve 0's) 

Ay F to Internal Connect Block 

Path i.d ' ae which Connect Initiate 

a recei 

Length to Mets point 


END con_blk; 


Cons 
STANT conlng oat: fy 
END coming; { 


*"" CHARACTER LENGTH ((.+7)8(-8))- if Force quadword alignment 
free_cxb QUADWORD ; 4 isthead of free CXB's 
END xwb; 


END_MODULE $xwbdef; 
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